deleteGraphic

Type

message

Summary

Sent to a graphic just before it is removed from the stack.

Syntax

deleteGraphic

Description

Handle the deleteGraphic message if you want to perform cleanup before a graphic is removed from the stack.

The actual deletion is not triggered by the deleteGraphic message, so trapping the message and not allowing it to pass does not prevent the graphic from being removed.

However, the undo command will restore a graphic after it is deleted by the user. For example, the following handler, placed in a card or stack script, effectively prevents a graphic from being deleted by the user:

    on deleteGraphic
        beep
        send \"undo\" to this card in 5 milliseconds
    end deleteGraphic

Examples

on deleteGraphic -- announce deletion to user
  answer "You just removed" && the name of the target
  pass deleteGraphic
end deleteGraphic

Related

command: delete

control structure: pass

glossary: handler, trap, message, command, graphic

keyword: card, graphic

object: stack

property: script

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile